home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmNNNNooootttteeeebbbbooooooookkkk - The Notebook widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Notebook.h> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN Notebook is a manager widget that organizes its children into pages, tabs, status areas, and page scrollers to simulate a real notebook. It stacks its page children so that all page children occupy the same area like real book pages. Notebook displays visuals that look like the binding of a book and the edges of other pages around the page that is shown. Tab children simulate notebook tabs. Major tabs divide Notebook into several sections, and minor tabs subdivide these sections. Status area children provide additional information about pages such as page numbers. The page scroller child allows the user to move from page to page. Notebook also provides tab scrollers for scrolling major and minor tabs if it cannot display all tabs within its edges. The application creates pages, tabs, status areas, and page scroller as children of the Notebook widget. Notebook creates tab scrollers when the Notebook is created. The XXXXmmmmNNNNnnnnooootttteeeebbbbooooooookkkkCCCChhhhiiiillllddddTTTTyyyyppppeeee constraint resource of Notebook determines whether a child widget is a page, tab, status area, or page scroller. Any Motif widget can be a page of the Notebook. When the application creates a child of the Notebook widget without setting the child type constraint, the child becomes a page by default, unless it has the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e, _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, or _X_m_Q_T_n_a_v_i_g_a_t_o_r trait. Children with the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e, _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, or _X_m_Q_T_n_a_v_i_g_a_t_o_r trait become major tabs, status areas, and page scrollers, respectively. Notebook uses the _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e, _X_m_Q_T_j_o_i_n_S_i_d_e, and _X_m_Q_T_n_a_v_i_g_a_t_o_r traits, and installs the _X_m_Q_T_s_c_r_o_l_l_F_r_a_m_e trait. The application attaches a tab to a page by creating a tab child of the Notebook and setting the XXXXmmmmNNNNppppaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr constraint to the page number of the targeted page. By the same method, a status area widget can be attached to a page. The page scroller child, on the other hand, is associated with the Notebook, not with a specific page. Therefore, there is only one valid page scroller for each Notebook. Page 1 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) PPPPaaaaggggeeeessss Only one child of type XXXXmmmmPPPPAAAAGGGGEEEE is displayed at a time by Notebook. Other page children are hidden off-screen. When Notebook displays a particular page, it positions the previously-displayed page off-screen and puts the new page in its place. The page is resized to fit into the dimensions that Notebook has allocated to display pages. PPPPaaaaggggeeee NNNNuuuummmmbbbbeeeerrrrssss Notebook uses the XXXXmmmmNNNNccccuuuurrrrrrrreeeennnnttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, and XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr resources to determine the current page and available page number range. Only those pages whose page numbers are within the range can be displayed. Other pages cannot be displayed until the range between XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr and XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr is changed to include them or their page numbers are changed to a number within the range. If XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr and XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr are not set explicitly by the application, they are set to 1 by default; Notebook sets XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrrto the largest page number assigned by the application thereafter by default. However, once XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr is set by the application, Notebook no longer changes it even when a page with a higher page number is managed. The XXXXmmmmNNNNppppaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr constraint resource is used for specifying the page number of a page widget. It can be set to any integer. For tab and status area children, the resource is used for linking the child widget to a page. For the page scroller child, the resource has no meaning and is ignored by the Notebook. When a page without a page number is managed, Notebook assigns it the smallest unallocated page number that is not less than the first page number and greater than the last allocated page number. When a tab or a status area without a page number is managed, the newly managed widget is assigned the page number of the most recently managed page, unless the page already has the same type of child. If the page does have the same type of child, Notebook assigns the newly managed widget a page number one greater than the most recently managed page; this new page number is now occupied. Notebook may generate a default page number greater than XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, making those pages inaccessible to the user. DDDDuuuupppplllliiiiccccaaaatttteeee aaaannnndddd EEEEmmmmppppttttyyyy PPPPaaaaggggeeeessss Since an application can create or change page numbers, it is possible to have duplicate page numbers and empty pages. When two pages with the same page number are managed, only the more recently managed page can be displayed. Inserting a Page 2 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) page with an existing page number does not cause a warning. The old page widget cannot be displayed until the new page widget is removed from the Notebook or until the page number of the old page widget is changed to some other number. An empty page is a page slot where no page is inserted. Empty pages occur when a tab or status area is associated with a page number that has no matching page widget. Empty pages display the blank Notebook background unless the application provides visual information to this empty area while processing XXXXmmmmNNNNppppaaaaggggeeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. NNNNooootttteeeebbbbooooooookkkk VVVViiiissssuuuuaaaallllssss Notebook draws lines around two sides of the top page to simulate the edges of other pages that are behind the top page. The XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeePPPPllllaaaacccceeeemmmmeeeennnntttt and XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn resources determine which two sides have the lines drawn around them. By default, they are drawn on the bottom and right sides of the top page. The application can set resources to control how many lines are drawn and how wide the area that they are drawn in is. Applications can also choose from three styles of binding visual that simulates the binding of a Notebook. Solid or spiral bindings can be drawn by Notebook, or the application can supply a pixmap that is tiled into the binding. TTTTaaaabbbbssss A major or minor tab is a Motif widget with the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e trait. If a widget without the trait is created for a tab, Notebook does not provide the page activation callback. As a result, even though the tab is displayed, it cannot automatically move the associated page to the top. Major tabs divide the Notebook pages into sections. Minor tabs subdivide these sections. Only minor tabs associated with the current section are displayed, where a section consists of the group of pages between the current major tab and the next major tab, including the current major tab but not including the page containing the next major tab. The exception to this is when there is no preceding major tab, in which case the section starts from the XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr value. A user in one major tab section does not see the minor tabs in other sections. However, all tabs are used in computing the size of the Notebook. Unlike regular notebook tabs, tabs in the Notebook are not attached to a physical page (a widget). They are, instead, attached to a logical page (a page number). Therefore, it is possible to have a tab with an empty page. When a page with a tab is removed from the Notebook, the tab is not removed because it is still bound to a logical page. Destroying or Page 3 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) unmanaging a page widget only erases the page and leaves an empty page. It does not tear the page out of the Notebook. To remove the tab, the application must explicitly destroy or unmanage it. Notebook supports the _X_m_Q_T_j_o_i_n_S_i_d_e trait. A widget that has the _X_m_Q_T_j_o_i_n_S_i_d_e trait can be added to the Notebook as a Major or Minor tab and will appear to be attached to its associated page with no margins or shadows between them. SSSSttttaaaattttuuuussss AAAArrrreeeeaaaassss A status area is any widget that is used for describing the associated page. For example, the Label widget as a status area child can hold a simple string or a pixmap that describes a page. A status area widget is also attached to a page by the page number constraint resource. Therefore, it is possible to have multiple status area widgets for one page. Only the most recently managed status area widget for that page can be displayed. All others for that page are not unmanaged, but their sizes are used for computing the size of the Notebook. If no status area widget is provided, the Notebook displays its blank background in the status area's reserved space. Notebook does not create any default status area widget. PPPPaaaaggggeeee SSSSccccrrrroooolllllllleeeerrrrssss The page scroller of the Notebook is any widget that the application creates for scrolling pages. If the application does not create one when the Notebook is realized, Notebook creates a SpinBox widget as the default page scroller. If the application creates a new page scroller, the default page scroller is destroyed. If the application creates multiple page scrollers, only the most recently managed one can be displayed and used. All others are unmanaged. The default SpinBox page scroller grays out one of the arrow visuals if the current page is a boundary page. If the current page is the first page, the previous arrow of the SpinBox is grayed. If the current page is the last page, the next arrow of the SpinBox is grayed. TTTTaaaabbbb SSSSccccrrrroooolllllllleeeerrrrssss Tab scrollers are created by the Notebook for scrolling major tabs and minor tabs. When Notebook is initialized, it creates four ArrowButtonGadgets for scrolling to the next major tab, the previous major tab, the next minor tab, and the previous minor tab. The application cannot replace these tab scrollers. The application can change all resources of these widgets except the position and the arrow direction. Tab scrollers are only visible and enabled when there is not enough space to display all the major or minor tabs appropriate to the page. Tab scrollers are also grayed Page 4 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) out when scrolling is inappropriate. The following lists the tab scrollers that are created: CCCChhhhiiiilllldddd WWWWiiiiddddggggeeeettttssss tttthhhhaaaatttt XXXXmmmmNNNNooootttteeeebbbbooooooookkkk CCCCrrrreeeeaaaatttteeeessss CCCChhhhiiiilllldddd NNNNaaaammmmeeee WWWWiiiiddddggggeeeetttt CCCCllllaaaassssssss Page Scroller PageScroller XmSpinBox Next Major Tab Scroller MajorTabScrollerNext XmArrowButtonGadget Previous Major Tab Scroller MajorTabScrollerPrevious XmArrowButtonGadget Next Minor Tab Scroller MinorTabScrollerNext XmArrowButtonGadget Previous Minor Tab Scroller MinorTabScrollerPrevious XmArrowButtonGadget When the user selects the page scroller, a major tab, or a minor tab, the value of XXXXmmmmNNNNccccuuuurrrrrrrreeeennnnttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr is changed to the selected page number and XXXXmmmmNNNNppppaaaaggggeeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk is invoked. After the application returns from the callback, the Notebook displays the last page child whose page number is equal to the current page number. It also displays the last matched status area child. All other pages and status areas are automatically hidden. Major tabs and minor tabs that can fit into the Notebook's edges are displayed and positioned appropriately. All other tabs are also hidden. The application can also cause a page change by calling XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss on XXXXmmmmNNNNccccuuuurrrrrrrreeeennnnttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr and then calling XXXXttttCCCCaaaallllllllCCCCaaaallllllllbbbbaaaacccckkkkssss on XXXXmmmmNNNNppppaaaaggggeeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. OOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn The Notebook has eight different visual configurations, depending on the value of XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeePPPPllllaaaacccceeeemmmmeeeennnntttt and XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn. These two resources determine the placement of back pages, the binding, major tabs, minor tabs, the status area, and the page scroller. The location of the binding is determined by XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn. Major tabs are always placed on the back page side opposite to the binding; Minor tabs are placed on the back page display area that is visually connected to the binding. Both Major and Minor tabs are ordered so that the page numbers they access increase as they get closer to the corner where the back pages meet. The status area and the page scroller are always located on the bottom of the Notebook, inside the frame. The page scroller is always placed adjacent to a back page side. The following table shows the possible configurations and the locations of each Notebook component within the configuration. The default back page value and the default orientation are based upon XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn. NNNNooootttteeeebbbbooooooookkkk CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnnssss XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeePPPPllllaaaacccceeeemmmmeeeennnntttt XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn MMMMaaaajjjjoooorrrr TTTTaaaabbbbssss SSSSttttaaaattttuuuussss AAAArrrreeeeaaaa BBBBiiiinnnnddddiiiinnnngggg MMMMiiiinnnnoooorrrr TTTTaaaabbbbssss PPPPaaaaggggeeee SSSSccccrrrroooolllllllleeeerrrr XmBOTTOM_RIGHT XmHORIZONTAL RIGHT BOTTOM LEFT LEFT BOTTOM BOTTOM RIGHT XmBOTTOM_RIGHT XmVERTICAL BOTTOM BOTTOM LEFT TOP RIGHT BOTTOM RIGHT Page 5 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XmBOTTOM_LEFT XmHORIZONTAL LEFT BOTTOM RIGHT RIGHT BOTTOM BOTTOM LEFT XmBOTTOM_LEFT XmVERTICAL BOTTOM BOTTOM RIGHT TOP LEFT BOTTOM LEFT XmTOP_RIGHT XmHORIZONTAL RIGHT BOTTOM LEFT LEFT TOP BOTTOM RIGHT XmTOP_RIGHT XmVERTICAL TOP BOTTOM LEFT BOTTOM RIGHT BOTTOM RIGHT XmTOP_LEFT XmHORIZONTAL LEFT BOTTOM RIGHT RIGHT TOP BOTTOM LEFT XmTOP_LEFT XmVERTICAL TOP BOTTOM RIGHT BOTTOM LEFT BOTTOM LEFT There are three tab groups for tab group traversal inside the Notebook: major tabs, minor tabs, and the page scroller. The application can also create additional types of tab groups within the Notebook; for example, each page added by the application is treated as a separate tab group by the traversal actions. CCCCllllaaaasssssssseeeessss Notebook inherits behavior, resources, and traits from CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes. The class pointer is _x_m_N_o_t_e_b_o_o_k_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmNNNNooootttteeeebbbbooooooookkkk. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssssfile, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmNNNNooootttteeeebbbbooooooookkkk RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbackPageBackground XmCBackPageBackground Pixel dynamic CSG XmNbackPageForeground XmCBackPageForeground Pixel dynamic CSG XmNbackPageNumber XmCBackPageNumber Cardinal 2 CSG XmNbackPagePlacement XmCBackPagePlacement unsigned char dynamic CSG XmNbackPageSize XmCBackPageSize Dimension 8 CSG Page 6 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XmNbindingPixmap XmCBindingPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNbindingType XmCBindingType unsigned char XmSPIRAL CSG XmNbindingWidth XmCBindingWidth Dimension 25 CSG XmNcurrentPageNumber XmCCurrentPageNumber int dynamic CSG XmNfirstPageNumber XmCFirstPageNumber int 1 CSG XmNframeBackground XmCFrameBackground Pixel dynamic CSG XmNframeShadowThickness XmCShadowThickness Dimension 0 CSG XmNinnerMarginHeight XmCInnerMarginHeight Dimension 0 CSG XmNinnerMarginWidth XmCInnerMarginWidth Dimension 0 CSG XmNlastPageNumber XmCLastPageNumber int dynamic CSG XmNminorTabSpacing XmCMinorTabSpacing Dimension 3 CSG XmNmajorTabSpacing XmCMajorTabSpacing Dimension 3 CSG XmNorientation XmCOrientation unsigned char XmHORIZONTAL CSG XmNpageChangedCallback XmCCallback XtCallbackList NULL C XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd Specifies the background color for drawing back pages. The default is a lower-intensity version of XXXXmmmmNNNNffffrrrraaaammmmeeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd. XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeeFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the forground color for drawing back pages. The default is taken from the application's default foreground color. XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr Specifies the number of lines to draw for back pages. The minimum value is 1, and the maximum value is (XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeeSSSSiiiizzzzeeee / 2). XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeePPPPllllaaaacccceeeemmmmeeeennnntttt Specifies where to place the back pages. The default is dependent on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the Notebook's instance parents. It can have one of the following values: XXXXmmmmBBBBOOOOTTTTTTTTOOOOMMMM____RRRRIIIIGGGGHHHHTTTT Displays back pages on the Notebook's bottom and right sides. XXXXmmmmBBBBOOOOTTTTTTTTOOOOMMMM____LLLLEEEEFFFFTTTT Displays back pages on the Notebook's bottom and left sides. XXXXmmmmTTTTOOOOPPPP____RRRRIIIIGGGGHHHHTTTT Displays back pages on the Notebook's top and right sides. XXXXmmmmTTTTOOOOPPPP____LLLLEEEEFFFFTTTT Displays back pages on the Notebook's top and left sides. Page 7 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XXXXmmmmNNNNbbbbaaaacccckkkkPPPPaaaaggggeeeeSSSSiiiizzzzeeee Specifies the thickness of the back page rendering. XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggPPPPiiiixxxxmmmmaaaapppp Specifies the pixmap or bitmap for stippling or tiling the binding when XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP or XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP____OOOOVVVVEEEERRRRLLLLAAAAPPPP____OOOONNNNLLLLYYYY. XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggTTTTyyyyppppeeee Specifies the binding type. It can have one of the following values: XXXXmmmmNNNNOOOONNNNEEEE Displays no binding. XXXXmmmmSSSSOOOOLLLLIIIIDDDD Displays a solid binding in the foreground color of the Notebook within the binding area specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh. XXXXmmmmSSSSPPPPIIIIRRRRAAAALLLL Displays a spiral binding in the foreground color of the Notebook within the area specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhhand within the area outside of the frame equal to the area specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh. XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP Displays the binding with the pixmap or bitmap specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggPPPPiiiixxxxmmmmaaaapppp as a stipple or tile. It uses the foreground color of the Notebook for stippling. The binding width is decided by the larger value of XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh and the width of the pixmap or bitmap. XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP____OOOOVVVVEEEERRRRLLLLAAAAPPPP____OOOONNNNLLLLYYYY Displays the binding with the pixmap or bitmap specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggPPPPiiiixxxxmmmmaaaapppp as a stipple or tile. It uses the foreground color of the Notebook for stippling. The binding is displayed only within the binding area specified by XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh. XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh Specifies the width of the Notebook binding. If XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggTTTTyyyyppppeeee is XXXXmmmmPPPPIIIIXXXXMMMMAAAAPPPP and the width of the pixmap specified in XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggPPPPiiiixxxxmmmmaaaapppp is greater than XXXXmmmmNNNNbbbbiiiinnnnddddiiiinnnnggggWWWWiiiiddddtttthhhh, then this resource is ignored and the width of the pixmap is used as the width of the Notebook binding instead. Page 8 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XXXXmmmmNNNNccccuuuurrrrrrrreeeennnnttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr Specifies the page number of the currently displayed page. Initially, it is set to XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr. If it is set to less than XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, then it is set to XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr. If it is set to XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, then it is set to XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr. XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr Specifies the page number for the first page of the Notebook. The Notebook does not scroll to any page numbers below this value. XXXXmmmmNNNNffffrrrraaaammmmeeeeBBBBaaaacccckkkkggggrrrroooouuuunnnndddd Specifies the background color for drawing the Notebook's frame. XXXXmmmmNNNNffffrrrraaaammmmeeeeSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss Specifies the shadow thickness around the Notebook's frame. XXXXmmmmNNNNiiiinnnnnnnneeeerrrrMMMMaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt Specifies the margin on the top and bottom sides of the page, status area, and page scroller widgets. XXXXmmmmNNNNiiiinnnnnnnneeeerrrrMMMMaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh Specifies the margin on the left and right sides of the page, status area, and page scroller widgets. XXXXmmmmNNNNllllaaaassssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr Specifies the page number for the last page of the Notebook. The Notebook does not scroll to any page numbers above this value. The default page number is the largest page number of managed page, major tab, or minor tab widgets. If this is set to a value that is less than XXXXmmmmNNNNffffiiiirrrrssssttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, the behavior of the Notebook is undefined. XXXXmmmmNNNNmmmmaaaajjjjoooorrrrTTTTaaaabbbbSSSSppppaaaacccciiiinnnngggg Specifies the spacing distance between major tabs. If XXXXmmmmNNNNffffrrrraaaammmmeeeeSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is greater than XXXXmmmmNNNNmmmmaaaajjjjoooorrrrTTTTaaaabbbbSSSSppppaaaacccciiiinnnngggg, then this resource is ignored and the size of XXXXmmmmNNNNffffrrrraaaammmmeeeeSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is used as the spacing distance between major tabs. XXXXmmmmNNNNmmmmiiiinnnnoooorrrrTTTTaaaabbbbSSSSppppaaaacccciiiinnnngggg Specifies the spacing distance between minor tabs. If XXXXmmmmNNNNffffrrrraaaammmmeeeeSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is greater than XXXXmmmmNNNNmmmmiiiinnnnoooorrrrTTTTaaaabbbbSSSSppppaaaacccciiiinnnngggg, then this resource is ignored Page 9 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) and the size of XXXXmmmmNNNNffffrrrraaaammmmeeeeSSSShhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is used as the spacing distance between minor tabs. XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn Specifies the orientation of the Notebook. It can have one of the following values: XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL Places the binding beside the pages, in the left or right side of the frame. XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL Places the binding above or below the pages, in the top or the bottom of the frame. XXXXmmmmNNNNppppaaaaggggeeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks to call whenever the XXXXmmmmNNNNccccuuuurrrrrrrreeeennnnttttPPPPaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr, representing the current page number, is changed. This includes the point when the widget is realized and the page number is initialized. The callback structure is XXXXmmmmNNNNooootttteeeebbbbooooooookkkkCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____MMMMAAAAJJJJOOOORRRR____TTTTAAAABBBB, XXXXmmmmCCCCRRRR____MMMMIIIINNNNOOOORRRR____TTTTAAAABBBB, XXXXmmmmCCCCRRRR____PPPPAAAAGGGGEEEE____SSSSCCCCRRRROOOOLLLLLLLLEEEERRRR____IIIINNNNCCCCRRRREEEEMMMMEEEENNNNTTTT, XXXXmmmmCCCCRRRR____PPPPAAAAGGGGEEEE____SSSSCCCCRRRROOOOLLLLLLLLEEEERRRR____DDDDEEEECCCCRRRREEEEMMMMEEEENNNNTTTT, or XXXXmmmmCCCCRRRR____NNNNOOOONNNNEEEE, depending upon what action caused the Notebook to display a new page. XXXXmmmmNNNNooootttteeeebbbbooooooookkkk CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNnotebookChildType XmCNotebookChildType unsigned char dynamic CG XmNpageNumber XmCPageNumber int dynamic CSG XmNresizable XmCResizable Boolean True CSG XXXXmmmmNNNNnnnnooootttteeeebbbbooooooookkkkCCCChhhhiiiillllddddTTTTyyyyppppeeee Specifies the child type of the Notebook. It can be one of the following types: XXXXmmmmPPPPAAAAGGGGEEEE The child is a page of the Notebook. This is the default when the child does not have the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e, _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l, or _X_m_Q_T_n_a_v_i_g_a_t_o_r trait. XXXXmmmmMMMMAAAAJJJJOOOORRRR____TTTTAAAABBBB The child is a major tab. This is the default when the child has the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e trait. XXXXmmmmMMMMIIIINNNNOOOORRRR____TTTTAAAABBBB The child is a minor tab. Page 10 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XXXXmmmmSSSSTTTTAAAATTTTUUUUSSSS____AAAARRRREEEEAAAA The child is a status area. This is the default when the child has the _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l trait and does not have the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e trait. XXXXmmmmPPPPAAAAGGGGEEEE____SSSSCCCCRRRROOOOLLLLLLLLEEEERRRR The child is the page scroller. The default page scroller is destroyed, if it exists. Any previously created page scrollers are unmanaged. This is the default when the child has the _X_m_Q_T_n_a_v_i_g_a_t_o_r trait and does have the _X_m_Q_T_a_c_t_i_v_a_t_a_b_l_e trait or the _X_m_Q_T_a_c_c_e_s_s_T_e_x_t_u_a_l trait. XXXXmmmmNNNNppppaaaaggggeeeeNNNNuuuummmmbbbbeeeerrrr Specifies the page number associated with the widget. If the widget is a page, the number specifies the page number of the widget. If the widget is not a page, the number specifies the page number of the associated page. If none is supplied by the application, Notebook generates the smallest unallocated page number when the child is managed. This resource is ignored for the page scroller. XXXXmmmmNNNNrrrreeeessssiiiizzzzaaaabbbblllleeee Specifies whether this child can request a resize. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss Notebook inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass. XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C XmNshadowThickness XmCShadowThickness Dimension 0 CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG Page 11 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNppppaaaaggggeeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk. typedef struct { int _r_e_a_s_o_n; XEvent *_e_v_e_n_t; int _p_a_g_e__n_u_m_b_e_r; Widget _p_a_g_e__w_i_d_g_e_t; int _p_r_e_v__p_a_g_e__n_u_m_b_e_r; Widget _p_r_e_v__p_a_g_e__w_i_d_g_e_t; } XmNotebookCallbackStruct; _r_e_a_s_o_n Specifies the reason for the callback. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. Page 12 (printed 4/6/01) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) _p_a_g_e__n_u_m_b_e_r Indicates the page number to be displayed. _p_a_g_e__w_i_d_g_e_t Indicates the page widget that has the new page number. It is NULL if no page widget with the page number is found. _p_r_e_v__p_a_g_e__n_u_m_b_e_r Indicates the page number of the currently displayed page. If the callback procedure is being called at widget initialization, this page number will be returned as XXXXmmmmUUUUNNNNSSSSPPPPEEEECCCCIIIIFFFFIIIIEEEEDDDD____PPPPAAAAGGGGEEEE____NNNNUUUUMMMMBBBBEEEERRRR. _p_r_e_v__p_a_g_e__w_i_d_g_e_t Indicates the currently displayed page widget. If the callback procedure is being called at widget initialization, NULL will be returned. TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss Notebook inherits translations from Manager. AAAAcccccccceeeelllleeeerrrraaaattttoooorrrrssss Notebook accelerators are added to all major tab and minor tab children of XmNotebook. Notebook accelerators are listed below. These accelerators might not directly correspond to a translation table. <<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>>:::: TraverseTab(_H_o_m_e) <<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>>:::: TraverseTab(_E_n_d) <<<<oooossssffffLLLLeeeefffftttt>>>>:::: TraverseTab(_P_r_e_v_i_o_u_s) <<<<oooossssffffRRRRiiiigggghhhhtttt>>>>:::: TraverseTab(_N_e_x_t) <<<<oooossssffffUUUUpppp>>>>:::: TraverseTab(_P_r_e_v_i_o_u_s) <<<<oooossssffffDDDDoooowwwwnnnn>>>>:::: TraverseTab(_N_e_x_t) AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss Notebook action routines are described below: TraverseTab(_H_o_m_e|_E_n_d|_N_e_x_t|_P_r_e_v_i_o_u_s) Moves the focus on major or minor tabs. AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr PPPPaaaaggggeeee 11113333 ((((pppprrrriiiinnnntttteeeedddd 4444////6666////00001111)))) XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmNNNNooootttteeeebbbbooooooookkkk((((3333XXXX)))) The Notebook widget has the additional behavior described below: <<<<TTTTaaaabbbb>>>> Notebook intercepts tab group traversal when traversal is entering or leaving major or minor tabs. It does this to support major tabs and minor tabs as two separate tab groups when they are actually treated as one by traversal. If a minor tab has keyboard focus and a user or program action specifies XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____PPPPRRRREEEEVVVV____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, keyboard focus will go to a major tab. If a major tab has keyboard focus and a user or program action specifies XXXXmmmmTTTTRRRRAAAAVVVVEEEERRRRSSSSEEEE____NNNNEEEEXXXXTTTT____TTTTAAAABBBB____GGGGRRRROOOOUUUUPPPP, keyboard focus will go to a minor tab. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). RRRREEEELLLLAAAATTTTEEEEDDDD CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeNNNNooootttteeeebbbbooooooookkkk(3), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), and XXXXmmmmNNNNooootttteeeebbbbooooooookkkkGGGGeeeettttPPPPaaaaggggeeeeIIIInnnnffffoooo(3). Page 14 (printed 4/6/01) 
